# CheckSelect 多项选择器

弹出一个下拉菜单给用户进行部分选项选择的操作。

## 何时使用

组件使用场景中文介绍

## 使用示例

<!-- Inject Stories -->

## Props

<!-- Inject Props -->

## Type

### CheckSelectMergedItem

> CheckSelectDataItem | CheckSelectGroupDataItem

#### CheckSelectDataItem

| 参数     | 说明              | 类型      | 可选值        | 默认值 |
| -------- | ----------------- | --------- | ------------- | ------ |
| id       | 选择项值，唯一 id | ReactText | -             | -      |
| title    | 选项标题          | ReactNode | -             | -      |
| disabled | 是否禁用该选项    | boolean   | true \| false | false  |

#### CheckSelectGroupDataItem

| 参数       | 说明       | 类型                  | 可选值 | 默认值 |
| ---------- | ---------- | --------------------- | ------ | ------ |
| groupTitle | 选项组标题 | ReactNode             | -      | -      |
| children   | 组选项列表 | CheckSelectDataItem[] | -      | -      |

### CheckSelectItemEventData

> 继承自 CheckSelectDataItem

| 参数   | 说明                           | 类型                     | 可选值 | 默认值 |
| ------ | ------------------------------ | ------------------------ | ------ | ------ |
| raw    | 关联用户传入的原始数据对象     | CheckSelectDataItem      | -      | -      |
| depth  | 该节点的层级，从 0（顶层）开始 | number                   | -      | -      |
| parent | 该节点的组信息                 | CheckSelectGroupDataItem | -      | -      |

### PopperOverlayProps

| 参数           | 说明                               | 类型                | 可选值                                                                                                                                                                                                     | 默认值         |
| -------------- | ---------------------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| className      | 弹层类名                           | string              | -                                                                                                                                                                                                          | -              |
| matchWidth     | 自动计算匹配吸附元素的宽度与其一致 | boolean             | true \| false                                                                                                                                                                                              | true           |
| placement      | 相对吸附元素的位置                 | PopperPlacementEnum | "top" \| "bottom" \| "right" \| "left" \| "top-start" \| "top-end" \| "bottom-start" \| "bottom-end" \| "right-start" \| "right-end" \| "left-start" \| "left-end" \| "auto" \| "auto-start" \| "auto-end" | "bottom-start" |
| container      | 指定 portal 的容器                 | HTMLElement         | -                                                                                                                                                                                                          | -              |
| disabledPortal | 禁用 portal                        | boolean             | true \| false                                                                                                                                                                                              | false          |
| arrow          | 是否展示箭头                       | boolean             | true \| false                                                                                                                                                                                              | false          |

### UseDataSource

| 参数              | 说明                               | 类型                             | 可选值                                             | 默认值        |
| ----------------- | ---------------------------------- | -------------------------------- | -------------------------------------------------- | ------------- |
| url               | 请求的 url                         | string                           | -                                                  | -             |
| method            | 请求方法                           | string                           | get \| post                                        | get           |
| data              | post 请求时请求体参数              | object                           | -                                                  | -             |
| params            | url 查询参数                       | object                           | -                                                  | -             |
| headers           | 请求头                             | object                           | -                                                  | -             |
| withCredentials   | 上传请求时是否携带 cookie          | boolean                          | true \| false                                      | false         |
| transformResponse | 成功时的回调，用于对数据进行预处理 | (response: object) => DataItem[] | -                                                  | -             |
| onError           | 请求发生异常的回调方法             | (error: object) => void          | -                                                  | -             |
| mode              | 请求模式                           | string                           | 'same-origin' \| 'cors' \| 'no-cors' \| 'navigate' | 'same-origin' |
